home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr08 / soundr10.zip / SOUNDER.NFO < prev    next >
Text File  |  1993-01-03  |  14KB  |  529 lines
  1.  
  2.  
  3.  
  4.  
  5.          December, 1992
  6.  
  7.  
  8.          Sounder is not designed to be a do-everything-for-everyone
  9.          utility and I hope it fills a gap in your research needs.
  10.          Questions, complaints, comments (good, bad and in-different)
  11.          and suggestions are welcomed.  Please make a note of the
  12.          comments on the opening screen and then, enjoy.
  13.  
  14.  
  15.          Patrick C. Deatherage
  16.          P. O. Box 202
  17.          League City, TX  77574-0202
  18.          (713) 332:3268
  19.  
  20.  
  21.          ps: Press F10 while viewing the opening screen and the
  22.              program will be patched to ignore it on start-up.
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ═════════════════════════════════════════════════════════════════
  71.                  Sounder - Freeware Version 1.0
  72.                          December 1992
  73. ═════════════════════════════════════════════════════════════════
  74.  
  75.  
  76. Sounder is a simple DOS based program that will calculate a
  77. Soundex code for one or more surnames and place the information
  78. in a database.  This information can then be viewed on-screen or
  79. printed in a two-column alphabetized list to be used as a handy
  80. reference during research.
  81.  
  82. Written in Clipper (Summer '87), Sounder creates a "standard"
  83. .DBF which can be read by most all database programs.
  84.  
  85. Clipper's SOUNDEX() function calculates the Soundex code in the
  86. program.  Note:  Apparently there has been two methods used in
  87. the past to generate Soundex codes - i.e. - the U.S. government
  88. uses one method in generating Soundex Cards and the more recent
  89. Tafel utility uses another.  Apparently Clipper uses the
  90. government's method.  Please report any discrepancies.
  91.  
  92.  
  93.                        Installing Sounder
  94.  
  95. Sounder Version 1.0 was released as SOUNDR10.ZIP and should
  96. contain the following files:
  97.  
  98.           Sounder.exe - the program
  99.           Sounder.nfo - this text file
  100.           Soundr1.ged - a sample .GED file, LDS format
  101.           Soundr2.ged - a sample .GED file, Roots III format
  102.  
  103. Create a directory on your hard disk by the name of SOUNDER,
  104. switch to that directory and unzip SOUNDR10 to that directory.
  105. Type SOUNDER to begin.  In DOS lingo,
  106.  
  107.           C: <whichever drive you wish to use>
  108.           MD \SOUNDER
  109.           CD \SOUNDER
  110.           PKUNZIP A:SOUNDER <B: if applicable>
  111.           SOUNDER
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127. ═════════════════════════════════════════════════════════════════
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. Sounder - Freeware Version 1.0                             Page 2
  137. ═════════════════════════════════════════════════════════════════
  138.  
  139.  
  140.                     Main Menu/Scroll Screen
  141.  
  142. Sounder utilizes a combined Main Menu and "Scroll Screen"
  143. routine.  Entries in the database are shown on the screen and can
  144. be navigated by using the UP & DOWN arrow, PAGE DOWN, PAGE UP,
  145. HOME, and END keys.  The menu options are selected by using the
  146. LEFT and RIGHT arrow keys and pressing ENTER will activate the
  147. hilited choice.  ESC will terminate the program and return
  148. control to the DOS prompt.
  149.  
  150.      Add    - add Surnames/Codes to the database
  151.  
  152.      Edit   - modify the hilighted Surname/Code
  153.  
  154.      Delete - remove selected entries from the database
  155.  
  156.      Import - scan GED, Tafel, Nameview/Namedrop files
  157.  
  158.      Print  - send selected entries of the database to the
  159.               printer or a text file
  160.  
  161.      Sort   - sort by surname or soundex code
  162.  
  163.      File   - not active this version
  164.  
  165.      Quit   - quit the program and return control to DOS
  166.  
  167.  
  168. Key Control:
  169.  
  170.     PageUp, PageDown, Up, Down, Home, End - navigate entries in
  171.     the data base shown on the scroll screen
  172.  
  173.     Left & Right Arrow Keys - hilite menu option
  174.  
  175.     Enter - activate menu option
  176.  
  177.     Space Bar - tag or untag the hilited entry
  178.     INS - activate ADD option
  179.     DEL - activate DELete option
  180.  
  181.     ^T - tag ALL entries
  182.     ^U - untag ALL entries
  183.  
  184.     F2 - create TAGLINE.TXT
  185.     F3 - activate print menu
  186.     F10 - quick quit to DOS from any menu
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193. ═════════════════════════════════════════════════════════════════
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. Sounder - Freeware Version 1.0                             Page 3
  203. ═════════════════════════════════════════════════════════════════
  204.  
  205.  
  206.                  Adding Entries to the Database
  207.  
  208. An entry is added to the database by selecting the ADD option on
  209. the main menu.  A box will appear.  Type in the desired surname
  210. and press ENTER.  Sounder will calculate the soundex code and
  211. verify that the name does not already exist in the database.
  212.  
  213. If the soundex code can not be calculated, a message box will
  214. appear.  If the surname is already in the database, a message box
  215. will appear.  A Yes/No prompt will appear before a new entry is
  216. added.  Use the Up and Down arrow keys to hilite the desired
  217. answer and press the RIGHT ARROW key or ENTER to active the
  218. choice.  Pressing ESC or the LEFT arrow key will tell Sounder not
  219. to add the entry.  As new entries are added, the last 9 will
  220. appear below the entry box.  If the ADD box was reached in error,
  221. or there are no additional names to include, leave the box blank
  222. and press ENTER.  The ESC key will also cancel the add routine.
  223.  
  224.  
  225.                 Editing Entries in the Database
  226.  
  227. Individual entries may be modified if necessary.  Hilite the name
  228. to be modified.  Hilite the EDIT option on the main menu and
  229. press ENTER.
  230.  
  231. The cursor will be at the soundex code field.  Type in the new
  232. information and press ENTER.  The cursor will advance to the name
  233. field.  Type in the new information and press ENTER.
  234.  
  235. The Up and Down arrow keys will also move the cursor between the
  236. two fields.  The PageDown key or ^W will also save the entry as
  237. it is written.  The ESC key will negate any changes and cancel
  238. the Edit routine.  The soundex code field may be left blank but
  239. the program will not allow the name field to be empty.
  240.  
  241.  
  242.                 Deleting Entries in the Database
  243.  
  244. Entries may be deleted from the database.  Hilite DEL at the main
  245. menu and press ENTER.  The Delete Menu will appear.  The hilited
  246. entry, all the tagged entries or ALL of the entries may be
  247. deleted.  Use the Up and Down arrow keys to hilite the desired
  248. action and press either the RIGHT ARROW key or the ENTER key.
  249.  
  250. Once entries are deleted, they are permanently removed from the
  251. database.  If an entry was accidently deleted it must be re-added
  252. through the ADD or IMPORT routines.  The delete option may be
  253. cancelled by pressing the LEFT ARROW key or the ESC key.
  254.  
  255.  
  256.  
  257.  
  258.  
  259. ═════════════════════════════════════════════════════════════════
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. Sounder - Freeware Version 1.0                             Page 4
  269. ═════════════════════════════════════════════════════════════════
  270.  
  271.  
  272.                         Importing Files
  273.  
  274. Sounder can scan Gedcom and Nameview .DAT files for surnames and
  275. will automatically place them in the database.  Tafel files are
  276. not handled at this time.  Sounder will not allow duplicate
  277. entries, so a file can be processed more than once without fear.
  278.  
  279. A gedcom file from the LDS Family Search Program is handled
  280. differently than a .GED produced by other genealogy packages.
  281. Sounder will attempt to determine the FSP type of file by reading
  282. the first "1 SOUR" (source) line.  If "IGI" or "SSDF" is
  283. designated, the program will assume the gedcom is from the Family
  284. Search Program.  Any other type of source information is found, a
  285. "Non-FSP" gedcom will be assumed.
  286.  
  287. The import routine is a two step process.  Sounder will
  288. automatically find both GED and Nameview/Namedrop DAT files but
  289. must be told which drive to search.  Which file to process must
  290. also be selected.
  291.  
  292.  
  293. Selecting a File Type
  294. ─────────────────────
  295. Select the desired type and press either the RIGHT ARROW key or
  296. ENTER.  The LEFT ARROW key will return the program to the main
  297. menu and scroll screen.
  298.  
  299. Choose "ALL" and all GED and Nameview/Namedrop DAT files will be
  300. listed for the drive selected.  If only GED files are desired,
  301. select either GED option.  If only DAT files are desired, select
  302. the DAT option.  The TT option is de-activated at this time.
  303.  
  304.  
  305. Selecting a Drive
  306. ─────────────────
  307. Hilite the desired drive and press either the RIGHT ARROW key or
  308. ENTER.  The LEFT ARROW key will return the program to the File
  309. Type Selection box.  All directories of the drive selected will
  310. be searched for the chosen file type.  The "ALL" drives option is
  311. not active at this time.
  312.  
  313.  
  314. Selecting a File to Process
  315. ───────────────────────────
  316. Use the Up, Down, PageUp, PageDown, Home, and End keys to
  317. navigate the list of files.  Use either the RIGHT ARROW key or
  318. ENTER to begin processing the hilited file.  The LEFT ARROW key
  319. will return the program to the File Type box.
  320.  
  321.  
  322.  
  323.  
  324.  
  325. ═════════════════════════════════════════════════════════════════
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. Sounder - Freeware Version 1.0                             Page 5
  335. ═════════════════════════════════════════════════════════════════
  336.  
  337.  
  338. Processing Files
  339. ────────────────
  340. The ESC key may be pressed during processing to cancel the
  341. routine.  If Sounder can not determine a soundex code for a name,
  342. it will be ADDED to the text file BADSNDX.TXT - and at the end of
  343. the import routine, a Yes/No box will allow for the option of
  344. viewing and/or deleting this file.  NOTE:  each time a file is
  345. processed, the "unknown" entries will be ADDED to this file so
  346. therefore if it is not occasionally deleted, it will continue to
  347. grow in size and take up unecessary disk space.
  348.  
  349.  
  350. LDS Gedcom
  351. ──────────
  352. The following is an example of a line from gedcom produced by the
  353. Family Search Program's IGI routine:
  354.  
  355.           1 NAME Sheila Mae/ILDERTON/
  356.  
  357. Sounder will only find the words between the slashes.
  358. Occasionally a name will be listed like:
  359.  
  360.           1 NAME Sheila Mae/ILDERTON or ELDERTON/
  361.  
  362. This version of Sounder assumes only what is between the slashes.
  363. Therefore, "ILDERTON or ELDERTON" will be listed in the database.
  364. Use the EDIT routine or DELete the offending entry at the main
  365. menu and ADD the correction.
  366.  
  367.  
  368. Gedcom - Other
  369. ──────────────
  370. The following is an example of a line from gedcom produced by
  371. Roots III:
  372.  
  373.     1 NAME Sheila Mae/Ilderton/Deatherage
  374.  
  375. Sounder will concentrate solely on the "1 NAME" lines.  The
  376. program will assume that the word between the two slashes is a
  377. surname.  Any word(s) found following the 2nd slash will also be
  378. considered as a surname.  Both will be included in the database.
  379. Roots III allows multiple names.  Consider the following:
  380.  
  381.     1 NAME Sheila Mae/Ilderton/Greene Halterman Deatherage
  382.  
  383. Sounder will attempt to separate up to the first 5 words after
  384. the surname between the slashes.  Depending on how the entries
  385. are recorded in the genealogy package, it is possible that titles
  386. such as Jr, Sr, Dr, and DDS will be considered a surname and
  387. included in the database.  the offending entry must be manually
  388. removed using the delete option at the main menu.
  389.  
  390.  
  391. ═════════════════════════════════════════════════════════════════
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. Sounder - Freeware Version 1.0                             Page 6
  401. ═════════════════════════════════════════════════════════════════
  402.  
  403.  
  404. Tafel (.TT)
  405. ───────────
  406. Until additional research can be done on the formal format of
  407. Tafel files, this feature is disabled even though the .TT files
  408. will be shown.
  409.  
  410.  
  411. Namedrop.dat/Nameview.dat
  412. ─────────────────────────
  413. Since Nameview and Namedrop allow keywords for any purpose as
  414. well as surnames in the .DAT file, a YES/NO prompt will request
  415. verification before adding a name to the database.
  416. Nameview/Namedrop users are aware that the keyword  list begins
  417. following the "~~" line in the .DAT file.  Sounder begins it's
  418. name processing following the double tilde.
  419.  
  420. Nameview and Namedrop are excellent message search and retrieval
  421. utilities that can be found on most genealogy related-bulletin
  422. boards.  Contact
  423.  
  424.         Ray Cox
  425.         17410 Huntersglen
  426.         Humble, TX  77396-1622
  427.  
  428. for additional information on or ordering Nameview and Namedrop.
  429.  
  430.  
  431.                      Printing the Database
  432.  
  433.  
  434. Select PRT at the main menu or press the F3 key.  The first Print
  435. Menu will appear.  Tell Sounder to either send the contents of
  436. the database to the text file SOUNDER.TXT or the printer.  The
  437. second menu is used to instruct Sounder to use ALL the entries or
  438. only the tagged entries.  Both print menus use the RIGHT ARROW
  439. key or ENTER to select the option while the LEFT ARROW key will
  440. cancel the print routine and return the program to the main menu.
  441.  
  442. The print output is "hard-wired" to utilized a two-column, 55-
  443. line result - and is sorted by the current active sort.  Press
  444. the ESC key during printing to cancel the routine.
  445.  
  446.  
  447.               Sorting the Entries in the Database
  448.  
  449.  
  450. There are two sorts available.  By Surname or Soundex code.
  451. Hilite SORT on the main menu to switch between the two.  The
  452. printed output, whether to the printer or SOUNDER.TXT, will be in
  453. the currently selected sort.
  454.  
  455.  
  456.  
  457. ═════════════════════════════════════════════════════════════════
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. Sounder - Freeware Version 1.0                             Page 7
  467. ═════════════════════════════════════════════════════════════════
  468.  
  469.  
  470.                            File Options
  471.  
  472.  
  473. The database created by Sounder is named SOUNDER.DBF and this
  474. version does not allow for additional .DBF's to be maintained.
  475. SOUNDER.DBF is a "standard" database file which can be read by
  476. any of the database systems such as DBASE III+, FoxPro etc.
  477.  
  478.  
  479.                       Quitting the Program
  480.  
  481.  
  482. Quit the program by selecting QUIT at the main menu and pressing
  483. ENTER.  Pressing the F10 key while at any of the menus will also
  484. immediately end the program and return control to the DOS prompt.
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523. ═════════════════════════════════════════════════════════════════
  524.  
  525.  
  526.  
  527.  
  528.  
  529.